Jenkins 配置工作节点

概述

当构建任务增多时，单节点 Jenkins 面临资源不足和单点故障问题。本文详解 Master-Slave 分布式架构，包括工作节点创建、SSH 连接配置、JDK 环境安装及任务绑定策略。

学习目标

1. 理解 Jenkins Master-Slave 架构原理
2. 掌握通过 SSH 添加工作节点的完整流程
3. 能够配置标签实现任务精确分配

一、Master-Slave 架构

为什么需要工作节点

二、前置准备

安装插件

工作节点要求

• 安装 JDK（版本与 Master 一致）
• 开放 SSH 端口（默认 22）
• 创建工作目录（如 /home/jenkins）

三、创建工作节点

路径：系统管理 → 节点管理 → 新建节点

基本配置

用法选项

四、SSH 连接配置

启动方式

选择：Launch agents via SSH

配置项

凭证类型

高级配置

五、工作节点安装 JDK

Jenkins Agent 需要 Java 运行环境，版本必须与 Master 一致。

# 查看 Master JDK 版本
docker exec jenkins java -version

# 在 Slave 节点安装（CentOS）
yum search java-11-openjdk
yum install java-11-openjdk-devel -y

# 验证
java -version

六、任务绑定节点

自由风格项目

General → 限制项目的运行节点 → 标签表达式: dev

Pipeline 项目

pipeline {
    agent {
        label 'dev'
    }
    stages {
        stage('Build') {
            steps {
                sh 'npm run build'
            }
        }
    }
}

标签表达式

常见问题

延伸阅读

• Jenkins 分布式构建文档
• SSH Build Agents 插件